ARDK for Android/com.nianticlabs.ardk/WPSLocation

WPSLocation

[androidJvm]
data class WPSLocation(val referenceLatitudeDegrees: Double, val referenceLongitudeDegrees: Double, val referenceAltitudeMetres: Double, val trackingToRelativeEdn: Pose)

Contains world positioning data from the WPS (World Positioning System).

WPSLocation provides global positioning information that combines GPS/GNSS data with visual positioning for enhanced accuracy and reliability.

Overview

WPS location data includes:

• Reference GPS coordinates (latitude, longitude, altitude)
• Transformation matrix for coordinate conversions
• Status information about positioning quality

Example

val result = wpsSession.getLatestLocation()
when (result) {
    is ARDKResult.Success -> {
        val location = result.value
        println("GPS Coordinates: ${location.referenceLatitudeDegrees}, ${location.referenceLongitudeDegrees}")
        println("Altitude: ${location.referenceAltitudeMetres} meters")

        // Use the transformation matrix for coordinate conversions
        val worldPosition = location.trackingToRelativeEdn
        placeARContent(worldPosition)
    }
    is ARDKResult.Error -> {
        println("WPS error: ${result.code}")
    }
}

Constructors

WPSLocation	[androidJvm] constructor(referenceLatitudeDegrees: Double, referenceLongitudeDegrees: Double, referenceAltitudeMetres: Double, trackingToRelativeEdn: Pose)

Properties

Name	Summary
referenceAltitudeMetres	[androidJvm] val referenceAltitudeMetres: Double Reference altitude in meters above sea level.
referenceLatitudeDegrees	[androidJvm] val referenceLatitudeDegrees: Double Reference latitude in degrees (WGS84 coordinate system).
referenceLongitudeDegrees	[androidJvm] val referenceLongitudeDegrees: Double Reference longitude in degrees (WGS84 coordinate system).
trackingToRelativeEdn	[androidJvm] val trackingToRelativeEdn: Pose Transformation matrix from tracking to relative coordinate system.